home *** CD-ROM | disk | FTP | other *** search
/ CD Exchange / CD Exchange - Volume 1.iso / utils / misc / bytefilter / bytefilter.doc < prev    next >
Text File  |  1993-10-14  |  4KB  |  114 lines
  1.  
  2.                              ByteFilter V1.20
  3.  
  4.                     Copyright (c) 1993 by Jan Hagqvist
  5.  
  6.  
  7. COPYRIGHT
  8.  
  9.     Copyright (c) 1993, Jan Hagqvist, All Rights Reserved.
  10.  
  11.     This program is FREEWARE. You may freely use and distribute this
  12.     program under the following conditions:
  13.  
  14.     1) No modifications are made into the program or this documentation
  15.        and all the files are spread together. However, you are allowed
  16.        to compress all the files into an archive for distribution.
  17.  
  18.     2) No money (other than nominal copying fees) is charged for its
  19.        distribution.
  20.  
  21. DISCLAIMER
  22.  
  23.     THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  24.     EITHER EXPRESSED OR IMPLIED. THE AUTHOR WILL NOT BE LIABLE FOR
  25.     ANY DAMAGES, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL,
  26.     RESULTING FROM THE USE OF THE PROGRAM. THE ENTIRE RISK AS TO THE
  27.     USE OF THIS PROGRAM IS ASSUMED BY THE USER.
  28.  
  29.  
  30. What is ByteFilter?
  31.  
  32.     ByteFilter lets you to filter out any bytes from any file you choose,
  33.     resulting a new file that lacks the filtered bytes. So you are able
  34.     to extract the texts from a binary file, for example.
  35.  
  36. How does it work?
  37.  
  38.     Simply enough, ByteFilter only reads the source file and writes it out
  39.     to the destination file, excluding the bytes to be filtered.
  40.  
  41. How do I use it?
  42.  
  43.     The gadgets:
  44.  
  45.     In the left you find the BYTE gadgets. They indicate which bytes are
  46.     to be filtered. Each gadget has a hex number representing the byte.
  47.     You can change the mode of a gadget by clicking on it. The first click
  48.     turns the gadget (and filtering of that byte) on and another click
  49.     turns the gadget off. None of these gadgets are selected when you
  50.     enter the program.
  51.  
  52.     The INVERT gadget simply inverts all the byte gadgets. So if a byte
  53.     gadget is selected, it will get deselected, whereas a deselected byte
  54.     gadget will get selected.
  55.  
  56.     Before you begin the filtering, you must fill in the SOURCE and the
  57.     DEST gadgets. In the SOURCE gadget you input the sourcefile name with
  58.     its full path (unless the sourcefile is in the current directory=the
  59.     directory where you started the program). The DEST gadget is just the
  60.     same as SOURCE, but it's for the destination file (a new file you
  61.     create by filtering out the desired bytes from the sourcefile).
  62.  
  63.     When you're done with the other gadgets, you can begin the filtering
  64.     by pressing the BEGIN THE FILTERING gadget.
  65.  
  66.     The statusline:
  67.  
  68.     In the bottom of the window you find the statusline. Here you can see
  69.     what's going on in the program.
  70.  
  71.  
  72.     The modes:
  73.  
  74.     ByteFilter automatically selects one of the following modes:
  75.  
  76.     Dead slow mode:  If there is not enough memory to read the whole
  77.              sourcefile into the memory, ByteFilter reads the
  78.              sourcefile 256 bytes at a time and writes out the
  79.              destfile 256 bytes at the time.
  80.  
  81.     Fast mode:     If there is enough memory to read the sourcefile
  82.              into the memory, but not enough memory for reading
  83.              the destfile into the memory, the sourcefile will
  84.              be completely read into the memory and the destfile
  85.              will be written 256 bytes at a time.
  86.  
  87.     Ultra fast mode: If there is enough memory for both the sourcefile
  88.              and the destfile, the sourcefile will be completely
  89.              read into the memory and then filtered. The destfile
  90.              will then be written in one go.
  91.  
  92. Notes
  93.  
  94.     When using the program, other programs may occasionally slow down,
  95.     because of the 260 gadgets (plus the system ones) in the program.
  96.  
  97.     This program needs jhextras.library version 37 or greater. A copy of
  98.     the library should accompany this program.
  99.  
  100.  
  101.     Should any comments come to your mind, please write to:
  102.  
  103.     Jan Hagqvist
  104.     Reinolankatu 5 A 1
  105.     48600 KARHULA
  106.     FINLAND
  107.  
  108.  
  109. History
  110.  
  111. V1.20    (Sunday, 05-Sep-1993)
  112.     Deadslow, fast and ultrafast-modes.
  113.     Size = 3288 bytes
  114.